home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 42 / Amiga Format AFCD42 (Issue 126, Aug 1999).iso / -serious- / comms / other / slrn / slrn_src / src / help.c < prev    next >
C/C++ Source or Header  |  1999-05-14  |  12KB  |  374 lines
  1. /* Copyright (c) 1998 John E. Davis (davis@space.mit.edu)
  2.  *
  3.  * This file is part of slrn.
  4.  *
  5.  * Slrn is free software; you can redistribute it and/or modify it
  6.  * under the terms of the GNU General Public License as published by the
  7.  * Free Software Foundation; either version 2, or (at your option) any
  8.  * later version.
  9.  * 
  10.  * Slrn is distributed in the hope that it will be useful, but WITHOUT
  11.  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  12.  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  13.  * for more details.
  14.  * 
  15.  * You should have received a copy of the GNU General Public License
  16.  * along with Slrn; see the file COPYING.  If not, write to the Free
  17.  * Software Foundation, 59 Temple Place - Suite 330, 
  18.  * Boston, MA  02111-1307, USA.
  19.  */
  20.  
  21. #include "config.h"
  22. #include "slrnfeat.h"
  23.  
  24. #include <stdio.h>
  25. #include <string.h>
  26.  
  27. #ifdef HAVE_STDLIB_H
  28. # include <stdlib.h>
  29. #endif
  30.  
  31. #include <slang.h>
  32. #include "jdmacros.h"
  33.  
  34. #include "slrn.h"
  35. #include "misc.h"
  36. #include "util.h"
  37.  
  38. static char *Global_Help [] = 
  39. {
  40.    " For more information about slrn, check out the newsgroups:",
  41.    "   news.software.readers",
  42.    "   alt.lang.s-lang",
  43.    " Email bug reports, suggestions, comments to davis@space.mit.edu",
  44.    "",
  45.    NULL
  46. };
  47.  
  48. static char *Art_Help[] =
  49. {
  50.    "Searching:",
  51.      "  /           Search forward in the article.",
  52.      "  a           Author search forward.",
  53.      "  A           Author search backward.",
  54.      "  s           Subject search forward.",
  55.      "  S           Subject search backward.",
  56.      "  =           Skip to next article of specified subject",
  57.      "  !           Skip to next article with high score",
  58.      "  ESC-l       Locate header by message-id.",
  59.      "Commands that affect the article:",
  60.      "  h           Hide window (zoom header window)",
  61.      "  SPACE       Select article or scroll to next page",
  62.      "  DEL, b      Scroll article back one page",
  63.      "  ESC-UP      Scroll article up one line",
  64.      "  ESC-DOWN    Scroll article down one line",
  65.      "  RIGHT       Pan article to the right",
  66.      "  LEFT        Pan article to the left",
  67.      "  W           Wrap or Unwrap article",
  68.      "  t           Toggle on/off the display of unimportant headers.",
  69.      "  T           Toggle on/off the display of quoted lines.",
  70.      "  TAB         Skip beyond quoted text.",
  71.      "  ESC-r       Toggle ROT 13 decryption on and off.",
  72.      "  g           Skip to next digest article.",
  73.    "  ESC Ctrl-C  Cancel article (you must be the author).",
  74.    "  ESC Ctrl-S  Supersede article, allowing you to edit original text.",
  75. #if SLRN_HAS_GROUPLENS
  76.      "  0           Assign article a GroupLens rating.",
  77. #endif
  78.      "Posting, Replying, Printing, Piping, and Saving:",
  79.      "  y           Send the article to the printer",
  80.      "  P           Post a new article (NOT followup)",
  81.      "  ESC P       Post a postponed article",
  82.      "  f           Followup to current article.",
  83.      "    Note: ESC 1 f ==> all headers will be inserted.",
  84.      "          ESC 2 f ==> the message will be inserted without quoting.",
  85.      "  F           Forward the article to someone",
  86.      "  r           Reply to the poster",
  87.      "  o           Append the article, thread, or tagged articles to a file",
  88.      "  :           Decode article, numerically tagged articles, or thread.",
  89.      "  #           Numerically tag the article for saving/decoding.",
  90.      "  ESC #       Remove numerical tags.",
  91.      "  |           Pipe the article to an external command.",
  92.      "Commands that pertain to the header window:",
  93.      "  d           Mark article as read and move to next unread.",
  94.      "  ESC-d       Mark thread as read and move to next unread.",
  95.      "  u           Mark the article as unread",
  96.      "  p           Move to a previously unread article",
  97.      "  n           Move to the next unread article or next group if at end.",
  98.      "  L           Goto the article that was last read.",
  99.      "  N           Skip to next news group.",
  100.      "  UP          Move to the previous article",
  101.      "  DOWN        Move to the next article",
  102.      "  ;           Set a mark at current position",
  103.      "  ,           Return to the previous mark setting mark first",
  104.      "  q           Quit back to group mode",
  105.      "  Ctrl-^      Decrease the size of the header window by one line",
  106.      "  ^           Increase the size of the header window by one line",
  107.      "  ESC t       Toggle collapse/uncollapse of thread",
  108.      "    Note: A prefix argument may be used to operate on all threads.",
  109.      "  ESC >       Move to the end of the header list",
  110.      "  ESC <       Move to the beginning of the header list",
  111.      "  Ctrl-U      Perform Page-Up on the header window.",
  112.      "  Ctrl-D      Perform Page-Dn on the header window.",
  113.      "  ESC-a       Toggle header display format",
  114.      "  ESC-s       Select sort mode",
  115.      "  ESC-p       Find parent header reading from server if necessary",
  116.      "  ESC 1 ESC p Reconstruct thread.",
  117.      "  ESC Ctrl-P  Find all children of current header (queries server)",
  118.      "  c           Catch-up (Mark ALL articles as read).",
  119.      "  ESC-u       Mark ALL articles as UN-read",
  120.      "  C           Mark articles TO the current position as read",
  121.      "  ESC-U       Mark articles TO current position as UN-read",
  122.      "  K           Create a score entry based on current header.",
  123.      "  ESC 1 K     Edit score file",
  124.      "  *           Mark header so it is un-affected by catchup commands.",
  125.      "  ESC 1 *     Un-mark all headers marked with '*'.",
  126.      "  x           Remove all read articles from list.",
  127.      "Miscellaneous:",
  128.      "  . (Period)  Repeat last key sequence",
  129.      "  U           Search for URL and follow it",
  130.      NULL
  131. };
  132.  
  133. static char *Group_Help [] =
  134. {
  135.      " Note: The keys are case sensitive!  That is, 's' and 'S' are not the same.",
  136.      "       Some commands take a prefix argument.  This means press ESC, then",
  137.      "       press a digit followed by desired command key sequence.",
  138.      "",
  139.      "Subscribing/Unsubscribing Hints:",
  140.      "  1. Press CAPITAL 'L' and enter the name of the groups to display, e.g.,",
  141.      "      *.music.*  to see all 'music' groups.",
  142.      "  2. Move to the group you want to subscribe to and then press 's'.",
  143.      "      Repeat this step for each group.",
  144.      "  3. Press the Capital-L key again to display only subscribed groups.",
  145.      "Commands that affect the current group:",
  146.      "  P                    Post an article to the current newsgroup",
  147.      "  ESC P                    Post a postponed article",
  148.      "  SPACE, RETURN        Select the current newsgroup.",
  149.      "   The following three variations permit viewing previously read articles:",
  150.      "  ESC 1 SPACE          Select group with article number query.",
  151.      "  ESC 2 SPACE          Select group but do not apply score.",
  152.      "  ESC 3 SPACE          Select group with query but do not apply score.",
  153.      "  s                    Subscribe to the current newsgroup",
  154.      "  ESC 1 s              Subscribe to pattern",
  155.      "  u                    Un-subscribe from the current newsgroup",
  156.      "  ESC 1 u              Un-subscribe to pattern",
  157.      "  c                    Catchup-- mark all articles as read",
  158.      "  ESC u                Un-Catchup-- mark all articles as un-read",
  159.      "Movement Commands:",
  160.      "  ESC <                Move to top of the list",
  161.      "  ESC >                Move to bottom of the list",
  162.      "  Ctrl-V, Ctrl-D       Scroll to next page",
  163.      "  ESC V, Ctrl-U        Scroll to previous page",
  164.      "  DOWN                 Move to next group",
  165.      "  UP                   Move to previous group",
  166.      "Miscellaneous Commands:",
  167.      "  a                    Add a new newsgroup (See 'L' help too!)",
  168.      "  Ctrl-L, Ctrl-R       Redraw the screen.",
  169.      "  Ctrl-Z               Suspend newsreader.",
  170.      "  l                    Toggle listing of groups that have no unread articles.",
  171.      "  L                    Toggle listing of unsubscribed groups.",
  172.      "  ESC 1 L              Hide unsubscribed groups",
  173.      "  /                    Group keyword search.  Use 'l' to search hidden groups.",
  174.      "  q